home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / dlcount.zip / DLCOUNT.DOC < prev    next >
Text File  |  1993-06-24  |  4KB  |  144 lines
  1.  
  2.  
  3.  
  4.  
  5. DLCOUNT 1.00
  6.  
  7. Powerboard BBS Download Count Maintainer
  8.  
  9. (c) 1993 Scott Brown
  10.  
  11. NuIQ Software, Inc.
  12. P.O. Box 832
  13. Larchmont, New York 10538
  14.  
  15. Tel: (914) 833-3479
  16. Fax: (914) 833-3623
  17. BBS: (914) 833-1479 v32b / (914) 834-7830 hst
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50. WARRANTY ----------------------------------------------------------------
  51.  
  52. There is no warranty on this software.  Please use it at your own risk.
  53. Backup your file area listings before you run this program.
  54.  
  55.  
  56. INTRODUCTION ------------------------------------------------------------
  57.  
  58. DLCOUNT 1.00 is a utility made specifically for Powerboard BBS version
  59. 1.2 that will provide means for your callers to find out which files
  60. are most popular.  When most popular files are clearly marked, callers
  61. will not have to try 10 different brands of the same type of program.
  62. Instead, they can use the popularity count as a reference.
  63.  
  64. DLCOUNT will read in your download logs, then sort and count number of
  65. times downloaded for each file, then re-write your file listings,
  66. appending to the last description line for each file the number of
  67. times downloaded.
  68.  
  69.  
  70. INSTALLATION ------------------------------------------------------------
  71.  
  72. To install DLCOUNT, simply un-zip into your main BBS directory.  After
  73. backing up your file area, you can then proceede to run the program for
  74. the first time by typing:
  75.  
  76. DLCOUNT DLCOUNT.CFG
  77.  
  78. and then pressing enter at the DOS prompt.  The runtime for the program
  79. will vary based on the number of downloads that have occoured on your
  80. system (logged to DOWNLOAD.<node>), and on the number of files available
  81. on your BBS in total.
  82.  
  83. Once DLCOUNT has completed processing your file areas, log on to your
  84. BBS.  After listing a file area where people commonly download files,
  85. you will see that the commonly downloaded files will be marked and will
  86. show the number of times people downloaded them.
  87.  
  88. If for some reason your file areas are no longer intact, and DLCOUNT
  89. did not work properly, DO NOT run any Powerboard file area utility,
  90. including DLCOUNT.  Instead, proceede to copy FILES.BAK files to
  91. FILES.BBS in each file area that is corrupted.  FILES.BAK is the
  92. backup file created by DLCOUNT, and FILES.BBS is the file that is
  93. read for the actual listing.
  94.  
  95.  
  96. CONFIGURATION -----------------------------------------------------------
  97.  
  98. DLCOUNT is ready to run in it's distributed state.  However, you options
  99. can be configured so that DLCOUNT behaves differently.
  100.  
  101. The ascii format for the DLCOUNT.CFG file is as follows:
  102.  
  103. 1. Path to Download Logs
  104. 2. Path to CD-ROM definitions (AREAS directory)
  105. 3. Path to MSGAREAS.BBS
  106. 4. Basic file area listing filename (AREAS\FAREA)
  107. 5. First part of text to append before [download number]
  108. 6. Second part of text to append after [download number]
  109. 7. First string of text to search for and remove
  110. 8. Next string
  111.  
  112. Example DLCOUNT.CFG file:
  113.  
  114. 1. logs\
  115. 2. areas\
  116. 3. msgareas.bbs
  117. 4. areas\farea
  118. 5.                                  -> Downloaded
  119. 6. times <-
  120. 7. -> Downloaded
  121.  
  122.  
  123. EVENTS ------------------------------------------------------------------
  124.  
  125. Ideally, DLCOUNT should be run in a nightly event.  This way, the file
  126. listings will be updated periodically.  After all, if you have the
  127. download statistics from last month in the listing, it will not be an
  128. accurate representation of which files are and which files are not
  129. popular.
  130.  
  131. If you do not have a nightly event already, you can create one using
  132. the EVCONFIG program.  Refer to the Powerboard manual to find out
  133. how to set up events.
  134.  
  135.  
  136. SPEEDING OPERATION ------------------------------------------------------
  137.  
  138. Because of the fact that DLCOUNT must sort through all files, the more
  139. files listed in your DOWNLOAD.<node> log, the slower operation will be.
  140. You may wish to consider copying DOWNLOAD.<node> to another directory
  141. and then deleting the DOWNLOAD.<node> from your logs directory once
  142. a month or so.  DLCOUNT will sort up to 10,000 files in memory.  After
  143. 10,000, files will have to be sorted on-disk.
  144.